home *** CD-ROM | disk | FTP | other *** search
/ 130 MIDI Tool Box / 130 MIDI Tool Box.iso / cmv15 / cmv.doc < prev    next >
Text File  |  1992-08-15  |  22KB  |  514 lines
  1.  
  2.  
  3.  
  4.                             CALLIOPE MUSIC VISION
  5.                             -=-=-=-=-=-=-=-=-=-=-
  6.              Copyright (c) 1992 Melvin Douglas All Rights Reserved
  7.                         Single-Track Midi Music Player
  8.                                    for the
  9.                            Sound Blaster Sound Card
  10.                             Version 1.5 July 1992
  11.                                   Shareware
  12.                               FAX (516)-533-2633
  13.  
  14.  
  15. Purpose:  Single Track Midi Music Player for Sound Blaster Owners.
  16.  
  17.  
  18. -----------
  19. LEGAL STUFF:
  20. -----------
  21.  
  22.     CALLIOPE MUSIC VISION software is hereafter referred to as CALLIOPE.
  23.  
  24.     Users of CALLIOPE must accept this disclaimer of warranty:
  25.  
  26.     "CALLIOPE  is  supplied as is.   The author disclaims  all  warranties,
  27.     expressed or implied, including, without limitation,  the warranties of
  28.     merchantability and of fitness for any purpose.   The author assumes no
  29.     liability for damages,  direct or consequential,  which may result from
  30.     the use of CALLIOPE."
  31.  
  32.     CALLIOPE is a "shareware program"  and is provided at no charge to  the
  33.     user  for evaluation.   Feel free to share it with your  friends,   but
  34.     please do not give it away altered or as part of another system.    The
  35.     essence  of "user-supported"  software is to provide personal  computer
  36.     users  with quality software without high prices,  and yet  to  provide
  37.     incentive for programmers to continue to develop new products.   If you
  38.     find  this  program  useful and find that you are  using  CALLIOPE  and
  39.     continue to use CALLIOPE after a 21 day trial period,  you must make  a
  40.     registration payment of $20.00 U.S Dollars.
  41.  
  42.        To register this copy, print and complete the REGISTER.FRM file
  43.        and send it along with the registration fee of $20 directly to:
  44.  
  45.                            Melvin Douglas
  46.                            Post Office Box 141
  47.                            Uniondale, New York
  48.                            11553-0141
  49.  
  50.     Adlib is a registered trademark of Adlib inc.
  51.     Sound Blaster is a registered trademark of Creative Labs Inc.
  52.     QuickBasic is a registered trademark of Microsoft Corp.
  53.  
  54.                PROGRAM FILES:
  55.                -------------
  56.                CMV.EXE       - Calliope program
  57.                CMV.DOC       - Calliope documentation
  58.                ROL2MIDI.EXE  - Conversion utility program
  59.                REGISTER.FRM  - Registration form
  60.                FILE_ID.DIZ   - BBS file description text
  61.                VENDOR.DOC    - Vendor distribution agreement
  62.                *.MDI         - several pre-converted midi music files
  63.  
  64. Note: A music file with the extension ".ROL" is an Adlib format sound file.
  65. ".ROL"   files may be found on almost any Bulletin Board system or  may  be
  66. purchased from many of the shareware distributors.  "ROL" files are usually
  67. accompanied by a BANK file (i.e., STANDARD.BNK).  Bank files hold the data
  68. for the various instruments used by the music file. A BANK file will be re-
  69. quired in order to perform conversions from ROL to MDI format.  Once you 
  70. have converted to MDI format, the BANK files are no longer reuired.
  71.  
  72. In  case you don't read any further,  note that you may use any key on  the
  73. command  line  as a switch to bypass the opening screen:  i.e.,   "CMV  X".
  74.  
  75. ------------------
  76. ABOUT THIS PROGRAM:
  77. ------------------
  78.  
  79. Thank you for trying CALLIOPE MUSIC VISION (CMV).  This program was created
  80. for use with a Sound Blaster sound board.   It will play single track  Midi
  81. compatible music files.  Included with CALLIOPE is a program (ROL2MIDI.EXE)
  82. which  allows  you  to easily convert a .ROL file into  a  Midi  compatible
  83. (.MDI) file, which is a type 0 midi.   CALLIOPE IS NOT CRIPPLED IN ANY WAY.
  84.  
  85. To convert any .ROL file to MIDI format you will need the following:
  86.    
  87.  1 - The .ROL file(s) to be converted into MDI format.     
  88.  2 - The BANK file (instrument file, i.e., STARDARD.BNK, BIGBANK.BNK, etc.)
  89.  
  90.  Then do the following from the DOS prompt:
  91.  
  92.    C>ROL2MIDI filename /Bbankfile /Onewfile
  93.  
  94.    for example, to convert ROCKNROL.ROL to ROCKNROL.MDI using the
  95.    STANDARD instrument bankfile: (.ROL files require Instrument bank files)
  96.  
  97.    C>ROL2MIDI rocknrol.rol /Bstandard.bnk /Orocknrol.mdi
  98.  
  99.    Note: Case is sensitive.
  100.  
  101. The  resulting  file is the only format that CALLIOPE  will  recognize  and
  102. play.   MDI files do not require Bank (.BNK)  or instrument files once they
  103. have been converted from their .ROL format into single track Midi's.    All
  104. of  the  musical information is self contained in a  single  compact  file.
  105.  
  106. Several  pre-converted  files are included so that you may  experience  the
  107. "Sight and Sound" of CALLIOPE immediately.  Simply copy all of the CALLIOPE
  108. files  into  a  separate  directory  and  type  CMV  (then  press   ENTER).
  109.  
  110. ---------------------
  111. HARDWARE REQUIREMENTS:
  112. ---------------------
  113.  
  114.     o  An IBM PC/XT/AT/386/486 or true "compatible" running
  115.        MS-DOS or PC-DOS 3.0 or later.
  116.  
  117.     o  528K System Memory.
  118.  
  119.     o  CGA/EGA/VGA Video Adaptor.
  120.        Note that screen activity may be sluggish on a CGA equipped
  121.        XT systems.
  122.  
  123.     o  One floppy disk drive or hard drive.
  124.  
  125.     o  A Sound Blaster Sound board.  
  126.  
  127.     NOTE: No "drivers" are required to run CMV.
  128.  
  129. ----------
  130. BACKGROUND:
  131. ----------
  132.  
  133. Like  many  others before me,  when I first purchased my  sound  board,   I
  134. rediscovered all of my old games which supported sound, and seemingly my PC
  135. was  a whole new thing again.   Then,  I became interested in  the  board's
  136. ability to play music (or simulate playing music).
  137.  
  138. Most of the available music players were good, but I found that I wanted to
  139. know more about the music that was playing...not just the filename and it's
  140. size.    I  also  wanted a display that was  dynamic  rather  than  static,
  141. something  that presented me with lots of information,  and I  wanted  more
  142. control of the file selection process too.
  143.  
  144. But there were so many music formats...rol's, mid's, mod's, cmf's and more.
  145. For some reason "Midi"  music appealed to me,  but programs that play  Midi
  146. music  were  mostly  for  multiple track Midi's  (.MID  files  -  Type  1).
  147.  
  148. Single  track  Midi's (.MDI - Type 0)  can be created  from  existing  .ROL
  149. files.   There must be a "bizillion" rol files in the world, so this format
  150. already   has   a   large  base  of  available   music   to   support   it.
  151.  
  152. Those are some of the reasons CALLIOPE was created.   Here is a list of the
  153. features that CALLIOPE will provide.   I hope you like them well enough  to
  154. make CALLIOPE your favorite Music Player.
  155.  
  156. --------
  157. FEATURES:
  158. --------
  159.  
  160.      MAIN FEATURES:
  161.  
  162.   -  Play up to 1000 songs, start to finish.
  163.   -  Play a single song from the command line.
  164.   -  Play a group of songs continuously.
  165.  
  166.   File Selection Via a Popup scrolling window, plus:
  167.   --------------------------------------------------
  168.  
  169.   -  Sort files by Name, Size or Date.
  170.   -  Tag or un-tag single files or ALL files.
  171.   -  Support for 1000 tagged files.
  172.  
  173.   A Play-Mode screen which provides the following information:
  174.   -----------------------------------------------------------
  175.  
  176.   -  Shows the amount of available conventional memory. (Refreshed
  177.      after each song is completed).
  178.   -  The I/O port address and IRQ location of your sound board.
  179.   -  Name of the current directory and or sub-directory.
  180.   -  Name of the music currently playing displayed in a scrolling panel.
  181.   -  Name of the next three music files that you have selected.
  182.   -  The total number of selections that you have made.
  183.   -  The number of selections remaining to be played.
  184.   -  The number of the current selection.
  185.   -  The elapsed time for the current selection.
  186.   -  The number of loops played if Music-Loop mode is active.
  187.   -  The ESTIMATED time for all remaining songs to be played.
  188.   -  The status of the AutoReplay toggle.
  189.   -  The status of the MusicLOOP toggle.
  190.  
  191.      Note that the word ESTIMATED is emphasized.  Time estimates are
  192.      based on an average-bytes-per-minute and readjust for each new song.
  193.      It may be off by plus or minus 5 minutes (or more).  It's only an
  194.      estimate.  Also note that all number counts STOP during a REPLAY and
  195.      continue when regular play is resummed.
  196.  
  197.   File Buffer Information:
  198.   -----------------------
  199.  
  200.   -  The current size of the buffer.
  201.   -  The byte currently being processed in the buffer (ascending).
  202.   -  The percentage of the buffer already processed.
  203.   -  The mode of the current music: MELODIC or PERCUSSIVE.
  204.  
  205.   A Status window to advise you of any changes:
  206.   --------------------------------------------
  207.   -  The Status Window will keep you advised of program changes/errors.
  208.   -  In addtion, the lower portion of the Status Window will advise you
  209.      if AutoReplay is active or not, since it is a delayed command.
  210.   -  Plus various symbols to provide an alternate measure of music duration.
  211.   -  A pointer-bar graphic across the top row for estimating the music
  212.      duration from a distance.  Admittedly, some of these are redundant,
  213.      but,.... so what?
  214.  
  215.   Active Play Controls are as follows:
  216.   -----------------------------------
  217.  
  218.   -  Pause the music.
  219.   -  Continue music from a paused state.
  220.   -  Skip the current music (immediate).
  221.   -  Interrupt music and Replay the CURRENT song.
  222.   -  Invoke a delayed interruption causing the current song to replay
  223.      upon its completion.  This is a TOGGLE command, and may be reversed.
  224.   -  Music-Loop mode locks the entire session in for continuous replay.
  225.      This is also a reversable TOGGLE command.
  226.   -  Cancel music play mode and return to the Main Menu.
  227.   -  Cancel music play mode and return to the File Selection Window.
  228.   -  While in the REPLAY screen, Pause, Continue and Exit are available.
  229.  
  230. -----------------
  231. CALLIOPE COMMANDS:
  232. -----------------
  233.  
  234. I  tried to make CALLIOPE as intuitive as possible so that you can  use  it
  235. "right out of the box".   However,  all software should contain at least  a
  236. brief   explanation   of   the  available  commands,   so   here   it   is:
  237.  
  238. When  CALLIOPE is first invoked,  the file selection window will popup  and
  239. search the current directory for all files with an extension of .MDI,   and
  240. will  present  a list of these files within this window.   If  no  matching
  241. files  are  found,  CALLIOPE will notify you of this via  a  popup  message
  242. window,   allowing you to return to the DOS prompt.   While the  files  are
  243. displayed, you may scroll the window up or down to view, select or deselect
  244. files. Selected files are marked with a Musical Note symbol for easy recog-
  245. nition.
  246.  
  247. --------------------
  248. COMMAND LINE OPTIONS:
  249. --------------------
  250.  
  251. You may play a single song from the command line by typing the program
  252. name followed by a space, and the FULL name of the selection.  For example,
  253. to listen to RAINYDAY.MDI, simply type CMV RAINYDAY.MDI (you must include
  254. the MDI extension with the filename).  Upon completion, you will be returned
  255. to the DOS prompt.  IMPORTANT NOTE: If for some reason you exit the music
  256. before it's completion and you find that a "stray" note refuses to end,
  257. you may type "CMV RESET" from the command line to "kill" the noise.  You
  258. will be returned to the DOS prompt immediately after CALLIOPE silences your 
  259. speakers or headphones.
  260.  
  261. As mentioned earlier, any single alphanumeric character on the command line
  262. will allow you to bypass the opening screen ie.,  "cmv z", where "z" may be
  263. any printable letter or number.
  264.  
  265. ---------------------
  266. FILE SELECTION WINDOW:
  267. ---------------------
  268.  
  269. The File Selection Window will automatically pop-up upon first invocation
  270. of the program.  On slower machines, this may take a second or two.  Other-
  271. wise, you may activate the File Selection Window by type Alt-M.
  272.  
  273. -------------------------------
  274. FILE (MUSIC) SELECTION COMMANDS:
  275. -------------------------------
  276.  
  277. NOTE:  YOU MUST "TAG" A FILE IN ORDER TO PLAY IT UNLESS YOU ARE PLAYING A
  278. SINGLE SELECTION FROM THE COMMAND LINE.
  279.  
  280. Tag  one file at a time by pressing the  RIGHT ARROW key, or <Shift> RIGHT
  281. ARROW key.   Unshifted,  the highlighted bar will move down one file  after
  282. each tag.   Shifted,  it will move up one file.  Un-tag is exactly the same
  283. except using the LEFT ARROW key.
  284.  
  285. <Num  Lock> will produce the same effect as <Shift> Left or  Right  arrows.
  286.  
  287. Tag  all files using (Ctrl> RIGHT ARROW,  and un-tag all files with  <Ctrl>
  288. LEFT ARROW.
  289.  
  290. Pressing RETURN after selecting files will immediately begin the Play  mode
  291. and music will start.  If you press Escape after making a selection(s), the
  292. selected files will be abandoned and you will be returned to the main menu.
  293.  
  294. Additionally, if you press RETURN without selecting any files, you will be
  295. returned to the main menu.
  296.  
  297. ----------
  298. SORT FILES:
  299. ----------
  300.  
  301. Sorting is easy, just pick a number (as follows):
  302.  
  303.     1 = Sort by filename.
  304.     2 = Sort by file size.
  305.     3 = Sort by file date.
  306.  
  307.  
  308.           During Music Play, the following commands are available:
  309.           -------------------------------------------------------
  310.  
  311. -------------
  312. PAUSE Command: (P)
  313. -------------
  314.  
  315. Pressing  "P"  will temporarily PAUSE the current music.   While  PAUSE  is
  316. active,   the  CONTINUE command is highlighted and other commands  will  be
  317. visually de-emphasized.   The elapsed time display will be blocked however,
  318. the time will continue to count-down in the background.
  319.  
  320. NOTE:  Occasionally, when you select the PAUSE command, it may get stuck on
  321. a note that refuses to be silent.  If this happens, use the "C"  command to
  322. CONTINUE  and  then use the "P"  command again until the sound  fades  out.
  323.  
  324. ----------------
  325. CONTINUE Command: (C)
  326. ----------------
  327.  
  328. Pressing "C"  will CONTINUE music, or reverse a PAUSE command. Music will
  329. resume playing from the point that it was PAUSED.
  330.  
  331. ------------
  332. SKIP Command: (S - or you may press the Spacebar)
  333. ------------
  334.  
  335. Pressing "S" will terminate the current music and will play the next music
  336. in the queue immediately.  You may also use this command to move to the next
  337. song if the current song gets "stuck" or just stops playing (probably a cor-
  338. rupt file). Skip is not available during REPLAY.  You may also press the
  339. SpaceBar to invoke this command.
  340.  
  341. The term "skip" in this instance  means that  the music was aborted during
  342. play rather than actually "skipped over" before being heard.
  343.  
  344.  
  345. --------------
  346. REPLAY Command: (R)
  347. --------------
  348.  
  349. Pressing  "R"  will instantly REPLAY the current music.   The program  will
  350. bring you to the INSTANT REPLAY screen,  and you will have the  opportunity
  351. to  Pause/Continue the REPLAY as you do in regular play mode.   You  cannot
  352. select the REPLAY Command (R)  if AutoREPLAY (A)  is currently active.   If
  353. you do, the word "C O N F L I C T" will quickly flash in the Status Window.
  354. This is to remind you that you have already requested a delayed REPLAY  for
  355. the  current selection.   If you must hear the music again NOW,  then  just
  356. press "A"  to deactivate AutoREPLAY and then press "R"  for REPLAY.   Watch
  357. the "Completed" status in the Buffer Window.  When the three "+++"  symbols
  358. are  red,   then  you  don't have much time left  for  a  REPLAY  decision.
  359.  
  360. After using Calliope for a while, you will find that the pointer bar graph
  361. at the top of the screen will be your most watched reference.
  362.  
  363. Note that if you decide to Exit the Replay screen,  you will be returned to
  364. the Main Menu, and any unheard selections will be lost.   The assumption is
  365. that you really want to hear a REPLAY and would not want to "Skip" it.   Of
  366. course  you  still have the choce of PAUSING it in case your  phone  rings.
  367.  
  368. ------------------
  369. AUTOREPLAY Command: (A)
  370. ------------------
  371.  
  372. Pressing "A"  will invoke the AutoREPALY Mode.   In this mode,  the current
  373. song  is "flagged"  for REPLAY upon it's completion in regular  play  mode.
  374. While the song is playing,  you may cancel or reinvoke AutoREPLAY as  often
  375. as you wish by simply press "A".
  376.  
  377. Pressing  "A"  will toggle AutoREPLAY to an ON or OFF state.   You will  be
  378. advised  of  it's current status on the bottom line of the  Status  Window.
  379. All  of the same conditions found in the REPLAY screen apply here as  well.
  380.  
  381. -----------------
  382. MUSICLOOP Command: (M)
  383. -----------------
  384.  
  385. Pressing "M" will invoke the MusicLOOP play mode.  In this mode, the entire
  386. music session will be replayed continously without interruption.  While in
  387. this mode, all of the other commands are still available.
  388.  
  389. Pressing "M" will toggle MusicLOOP to an ON or OFF state.  You will be 
  390. advised of it's current status on the bottom line of the screen. In addition,
  391. the current Loop Number will be displayed.  Pressing "F" or "X" will also
  392. terminate the MusicLOOP mode.
  393.  
  394. ---------------------------
  395. FILE WINDOW  [EXIT] Command: (F)
  396. ---------------------------
  397.  
  398. Pressing "F" will terminate CALLIOPE's music play mode and return you to to
  399. the  FILE SELECTION WINDOW where you may select more songs to play or  exit
  400. to the Main Menu.  This command will terminate MusicLOOP if active.
  401.  
  402. ------------
  403. EXIT Command: (X - or you may press the Escape Key)
  404. ------------
  405.  
  406. Pressing  "X"  will shut down CALLIOPE's music play mode and return you  to
  407. the  main menu.   On the other hand,  when the last song has  been  played,
  408. CALLIOPE will exit the Play Mode and return you to the main menu.   At that
  409. point   the,   the  File  Selection  Window  will   pop-up   automatically.
  410. This command will terminate MusicLOOP if active.  You may also press the
  411. Escape key to invoke this command.
  412.  
  413. -------------------
  414. ENDING THE PROGRAM: (ESC - from main menu)
  415. -------------------
  416.  
  417. Pressing  ESCape from the main menu will terminate CALLIOPE and return  you
  418. to the DOS prompt (assuming the File Selection Window was not active).   If
  419. the File Selection Window is active, pressing ESCape 3 times will  terminate
  420. CALLIOPE, and return you to the DOS prompt while displaying a low key share-
  421. ware screen and session statistics.
  422.  
  423. ------
  424. ERRORS:
  425. ------
  426.  
  427. If  a music file gets stuck at it's termination point and attempts to  loop
  428. itself and start over, CMV will force it to terminate, and will display the
  429. message "filename was PUSHED" in the status window.  "PUSHED"  means it was
  430. forced  off  of the queue by the Calliope Police who constantly  watch  for
  431. this sort of behavior.
  432.  
  433.                              Some important notes:
  434.  
  435.  o  If the length of your path is exceedingly long, it could conceivably
  436.     overwrite the elapsed time area of the screen.
  437.  
  438.  o  All graphics are text based and therefore do not require a VGA monitor.
  439.     However, the program was created on a system with a VGA monitor.
  440.  
  441.  o  EMS is not supported in this version, but it may be introduced in a
  442.     future version as the program grows larger and more memory is required.
  443.  
  444.  o  A music file larger that 65,520K will force an error condition, in
  445.     which case you will be returned to the main menu (hopefully).
  446.  
  447.  o  CMV was created on a 386 16Mhz system, running DOS 5.0 with 640k
  448.     memory.  The sound card was a Sound Blaster v1.5 (original).
  449.     Programming language: QuickBasic version 4.5
  450.  
  451.  o  Sometimes when a music file suddenly stops playing, it may be corrupt.
  452.     Reconvert it from your original .ROL file and try again.
  453.  
  454.                             Version History
  455.  
  456.     Version 1.0  = Initial 'closed distribution' release. (no uploads).
  457.     Version 1.1  = Added bar graph/new screens. Ensure file size within limits.
  458.     Version 1.2  = Bug fix and reduced memory usage. Official release.
  459.     Version 1.3  = Added "F" command to access File Window from Play Mode.
  460.     Version 1.4  = Music Queue now displays the next 3 songs in the Queue.
  461.                    Added "Estimated Time" (minutes) for all songs to play.
  462.                    Enhanced error checking while each song plays.
  463.                    Removed the limited mouse support.
  464.                    "Any key" will now bypass the opening screen.
  465.                    Added "R" for Instant Replay.
  466.                    Added "A" for delayed automatic Replay.
  467.                    Added various corrective/functional/cosmetic screen updates.
  468.                    Additional stats upon exit from the program.
  469.     Version 1.5  = Added command line option to play a single selection.
  470.                    Added command line option to silence speakers.
  471.                    Added MusicLoop continuous play mode.
  472.  
  473.     ---------------------------------------------------------------------
  474.     Questions or problems? My direct FAX number is (516) 538-2633.
  475.  
  476.     The latest version of CMV may be found on the following bulletin boards:    
  477.     ---------------------------------------------------------------------
  478.                 1 -  The Executive Network BBS, New York
  479.                      914-667-4684 all baud speeds
  480.     ---------------------------------------------------------------------
  481.  
  482.                 2 -  The Invention Factory, New York
  483.                      212-431-1254
  484.  
  485.                 3 -  Digital Zero, New York
  486.                      212-353-8415
  487.  
  488.                 4 -  Computer Connection, Washington, D.C.
  489.                      202-543-8088
  490.  
  491.                 5  - Vernon Buerg's BBS, Calif.
  492.                      707-778-8944
  493.  
  494.                 6  - Gene Plant's BBS, Illinois
  495.                      708-843-8664
  496.  
  497.                 7  - The SoundBlaster Digest BBS, Toronto
  498.                      416-840-2485
  499.  
  500.         Special Thanks to Ro and Joe Malacria, and Dennis Anderson...
  501.         ...and Executive Network BBS, the BEST international bulletin board.
  502.  
  503.  
  504.  
  505.  
  506.  
  507.  
  508.  
  509.  
  510.  
  511.  
  512.  
  513.  
  514.